home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / Bell / BellPrefs.doc < prev    next >
Text File  |  1996-09-26  |  4KB  |  129 lines
  1.  
  2.                                  BellPrefs
  3.                                  ---------
  4.            Documentation for version 2.1, on January 16th, 1992
  5.  
  6.                               by Bruno Costa
  7.  
  8.  
  9.  
  10. WARNING
  11.  
  12.   Although  this  program  is freely distributable (see COPYRIGHT below), I
  13. would  appreciate  if  you  take the time to write me a line or two (E-Mail
  14. please)  if  you  are  using  any of my programs or if you have any kind of
  15. ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
  16. particularly  generous,  I  would  like  to  receive a disk with any useful
  17. programs you have written, preferrably with source.  Thanks!
  18.  
  19.  
  20. DESCRIPTION
  21.  
  22.   BellPrefs  is an interactive, Intuition based preferences module that can
  23. be  used  to  configure Bell.  It uses the WB 2.0 user interface style, and
  24. works  just  like the preferences modules already in your SYS:Prefs drawer.
  25. It  allows  a  digitized sound to be selected through a file requester, and
  26. played  with  any  combinations  of  volume  and  pitch  values.  The sound
  27. waveform is displayed graphically, and the program works under WB 2.0 only.
  28.  
  29.  
  30. OPTIONS
  31.  
  32.   usage: BellPrefs       (no options)
  33.  
  34.   The  program is completely interactive, and does not support command line
  35. parameters  (yet?).   It can also be run from Workbench, and an appropriate
  36. icon  is  provided so that it can be placed in your SYS:Prefs drawer.  When
  37. run, it opens a window with a couple of gadgets and menu items that will be
  38. described:
  39.  
  40.   GADGETS:
  41.  
  42.     Visual  Bell:   determines  if the bell should be visible, i.e., if the
  43. screen should flash when an error occurs.
  44.  
  45.     Audible  Bell:   determines if the bell should be audible, i.e., if the
  46. sound should be played when an error occurs.
  47.  
  48.     Volume:   determines  the  volume  at  which the sound is to be played,
  49. ranging from 0 to 64 (loudest).
  50.  
  51.     Speed:   determines  the speed at which the sound is to played, ranging
  52. from 4000 to 16000 (fastest).  The faster a sound is played, the higher the
  53. pitch will be.
  54.  
  55.     Sound  File:   this string gadget contains the full pathname of the IFF
  56. 8SVX  sound file.  If you type a pathname and hit return, the sound will be
  57. loaded  and  the  volume  and  speed gadgets will be changed to reflect the
  58. default values stored in the file.
  59.  
  60.     Select:  this gadget brings up a file requester to select interactively
  61. the sound file pathname.
  62.  
  63.     (Graphic):  this gadget, when hit, will simulate what will happen in an
  64. error  condition  according  to  the  current settings.  This may produce a
  65. screen  flash  (if  the  Visual Bell is enabled) or a sound (if the Audible
  66. Bell is enabled) or both (or even none).
  67.  
  68.     Save:  saves the current preferences on disk (ENVARC:).
  69.  
  70.     Use:   saves the current preferences in memory (ENV:), and signals Bell
  71. that the preferences have been changed.
  72.  
  73.     Cancel:  self-explanatory.
  74.  
  75.  
  76.   MENUS:
  77.  
  78.     Project/Open...:   loads  a bell preferences file, selected from a file
  79. requester.
  80.  
  81.     Project/Save  As...:  saves a bell preferences file, in a file selected
  82. from a file requester.
  83.  
  84.     Project/Quit:  quits.
  85.  
  86.     Edit/Reset To Defaults:  resets all options to the internal defaults.
  87.  
  88.     Edit/Last Saved:  resets all options to the ones saved in ENVARC:.
  89.  
  90.     Edit/Restore:  resets all options to the ones saved in ENV:.
  91.  
  92.  
  93. BUGS
  94.  
  95.   Should  support  some  command  line  parameters,  just  like  the system
  96. preferences modules.
  97.  
  98.  
  99. AUTHOR
  100.  
  101.   The  accompanying  program  and  this documentation were written by Bruno
  102. Costa.  He can be reached in the following ways:
  103.  
  104.   E-Mail: bruno@brlncc.bitnet (InterNet)
  105.           bruno@BRLNCC        (BitNet)
  106.  
  107.   Mail:   Bruno Costa
  108.           Rua Almirante Guilhem 454/102 bloco 1
  109.           Leblon - Rio de Janeiro
  110.           RJ 22440
  111.           BRAZIL
  112.  
  113.  
  114. COPYRIGHT
  115.  
  116.   This program is copyrighted by Bruno Costa.  It may be freely distributed
  117. if  and  only  if  the  documentation  and  the executables are provided in
  118. original form.  It may be included in Public Domain/Shareware compilations,
  119. like  the  one  organized  by  Fred  Fish, as long as just a nominal fee is
  120. charged  for  each  disk  (no  more  than  US$10 per disk), and may also be
  121. uploaded to BBS's or network services like BIX and CompuServe.
  122.  
  123.  
  124. DISCLAIMER
  125.  
  126.   The author makes no warranty of any kind with respect to this product and
  127. explicitly  disclaims  any implied warranties of merchantability or fitness
  128. for  any  particular  purpose.
  129.